Template Method 
Pattern 


public class Coffee { 


Example 



Coffee recipe: 

• boil some water 
brew coffee in 
the water 

P8 pour coffee in 
cup 

• add sugar and 
milk 


Tea recipe: 

• boil some 
water 

• steep tea in 
the water 

• Remove tea 
from water 

• Pour cup of tea 

• Add sugar, 
milk or lemon 



public class Tea { 


public void makeRecipe() { 
boilWater(); 
brewCof feeGrinds () ; 
pourlnCup(); 
addSugarAndMilk <) ; 

} 


public void boilWater() { 

_System.out.println( 

2llina_w.ater" ) ; _ 


public void brewCoffeeGrinds() { 

System.out.printIn( "Brewing the coffee" ); 

} 

public void pourlnCupO { 

System.out.println( "Pouring into cup" ); 

} 


publid vdid riAk6K<=sdlp6 U { - 

boilWater() ; 
steepTea() ; 
removeTea(); 
pourlnCup(); 
addSugarMilkLemon(); 

} 

public void boilWater() { 

System.out.println( "Boiling water" ); 

} 

public void steepTeaBag() { 

System.out.println( "Steeping the tea" ); 

} 

public void removeTea() { 

System.out.println( "Remove Tea" ); 

} 

public void pourlnCup () { 

System.out.println( 


public void addSugarAndMilk() { 

System.out.println( "Adding sugar, milk" ); 


} 


"Pouring into cup" ); 














Similar Algorithms 

General recipe: 

• boil some water 

• use the water to extract coffee or tea 

• pour resulting beverage into a cup 

• add appropriate condiments to the 
beverage 
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public void 
makeRecipe() { 
boilWater(); 
brewCoffeeGrinds () ; 
pourlnCup(); 
addSugarAndMilk () ; 


// in Tea class 

template 

public void method 

makeRecipe() { 
boilWater(); 
steepTeaBag () ; 

RemoveTeaBag () ; 
pourlnCup(); 
addSugarMilkLemon (); 


public abstract class HotCaffeineBeverage { 

// oorvoo like a "t - omta - kato" fo —i a - 1 - gorl - t - fom i 

// where subclasses provide certain parts 
public final void makeRecipe() { 
boilWater() ; 

brew () ; // from subclass 

pourlnCup(); 

addCondiments(); II from subclass 

} 

// let the subclasses determine how 
public abstract void brew(); 
public abstract void addCondiments(); 


public void boilWater{) { 

System.out.println( "Boiling water" ); 

} 


Similar Algorithms 

// in Coffee class 


public void pourlnCup0 { 

System.out.println( "Pouring into cup" ); 

} 
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// subclasses inherit 
// makeRecipe, boilWater, pourlnCup 

public class Coffee extends HotCaffeineBeverage { 

public void brew() { 

System.out.println( "Brewing the coffee" ); 

} 

public void addCondiments() { 

System.out.println( "Adding sugar, milk" ); 



public class Tea extends HotCaffeineBeverage { 
public void brew() { 

System.out.println( "Steeping the tea" ); 
System.out.println( "Removing the tea" ); 

} 

public void addCondiments() { 

System.out.println( "Adding lemon" ); 

} 

} 



Why Template Method? Why Template Method? 


Before: 

Coffee and Tea have the 
algorithm 


near duplicated code in 
Coffee and Tea 


changing the algorithm 
requires opening the 
subclasses and making 
multiple changes 


After: 

HotCaffeineBeverage 
has the algorithm 


reduces duplication and 
enhances reuse 


algorithm is found in 
one place, so changes 
to it are localized 


Before: 

original structure 
requires more work 
to add a new 
subclass 
(need to provide 
the whole 
algorithm again) 


After: 

new structure 
provides a 
framework to add a 
new subclass (need 
to provide just the 
distinctive parts of 
the algorithm) 
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Template Method Pattern 

Design intent: 

“define the skeleton of an 
algorithm in a method, 
deferring some steps to 
subclasses" 


Consequences 

Results: 

inverted control 

• superclass method calling 
subclass method 

"Hollywood principle" 

• "Don't call us, we'll call you." 


Template Method Structure 
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“Hooks" 

Idea: 

methods in the superclass which provide 
default behavior that the subclasses may 
override 


often hook methods do nothing by default 
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Exercise 

Problem: 


customize for different header and footer 
common body text 
optional watermark 


// subclasses must override 

public abstract void primitiveOperationl(); 
public abstract void primitiveOperation2(); 

// do nothing by default; 

// subclass may override 
public void hook() { } 


■I-::, 


page object to be printed 


Hooks' 


public abstract class AbstractClass { 
public final void templateMethod() 
primitiveOperationl(); 
primitive0peration2(); 
hook(); 
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public abstract class Page { 


public class DraftPage extends Page { 



// template method 
oublic final void print() { 
printHeader(); 
printBody(); 
printFooter(); 
printWatermark(); 


// subclasses must provide header and footer 
public abstract void printHeader(); 
public abstract void printFooter(); 

/! print the page body 
public void printBody() { 



// print the page header 
public void printHeader() { 

} 

// print the page footer 
public void printFooter() { 

} 

public void printWatermark() { 
// print a DRAFT watermark 


// do nothing by default, i.e., no watermark } 

public void printWatermark() { } i 
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Factory Method 
Pattern 


Dealing with new 

// limited, what if new pizza types? 
PepperoniPizza pizza = new PepperoniPizza(); 

// code to bake, cut, box PepperoniPizza 


//or have subclasses of a Pizza abstract superclass 
if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza(); 

} 

// code to bake, cut, box Pizza 


Should depend upon abstractions , 
not directly upon concrete classes. 


Attempt 1 

// general pizza ordering method 
public Pizza orderPizza() { 

Pizza pizza = new Pizza (); 

pizza.bake(); 
pizza.cut (); 
pizza.box(); 

return pizza; 

} 


for flexibility, 
would like to use 
the superclass name 
here, but it is 
abstract 


Attempt 2 

// general pizza ordering method 
public Pizza orderPizza( Pizza pizza ) { 

pizza .bake (); st/// need code somewhere 

pizza. cut (); fo instantiate a specific 

pizza !box (); type of pizza, and pass it in 

return pizza; 

} 
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Attempt 3 

// general pizza ordering method 
public Pizza orderPizza( String pizzaType ) { 

Pizza pizza; 


Attempt 3 with Changes 

// general pizza ordering method 

public Pizza orderPizza( String pizzaType ) { 

Pizza pizza; 


} 


if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza() ; 


} 

pizza.bake(); 
pizza.cut (); 
pizza.box (); 

return pizza; 



tends to 
change 


tends to 
stay the 
same 

} 


if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 
Pizza pizza = new VeggiePizza(); 

} else if (pizzaType.equals( "hawaiian" ) { 
Pizza pizza = new HawaiianPizza(); 


pizza.bake(); 
pizza.cut (); 
pizza.box(); 

return pizza; 
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Simple Factory Approach 

// separate factory class to create a Pizza 

public class SimplePizzaFactory { 

public Pizza createPizza( String pizzaType ) { 

Pizza pizza = null; 

if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = new PepperoniPizza(); 

} else if (pizzaType.equals( "veggie" ) { 

Pizza pizza = new VeggiePizza(); 

} 

return pizza; 

} 

} 


Using a Factory Object 

public class PizzaStore { 

private SimplePizzaFactory factory; 

public PizzaStore( SimplePizzaFactory factory ) { 
this.factory = factory; 

} 

public Pizza orderPizza( String pizzaType ) { 
Pizza pizza; 


pizza = factory.createPizza( pizzaType ); 


pizza.bake (); 
pizza.cut (); 
pizza.box(); 

return pizza; 
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Factories 



Using Factories 

PizzaStore newYorkStore = new PizzaStore( 
new NewYorkPizzaFactory() 

) ; 

newYorkStore.order( "veggie" ); 


PizzaStore chicagoStore = new PizzaStore( 
new ChicagoPizzaFactory() 

) ; 

chicagoStore.order( "veggie" ); 
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Factory Method Approach 


public abstract class PizzaStore { 


public Pizza orderPizza( String pizzaType 
Pizza pizza; 


keep 

orderPizza 
general 
and 

decoupled 
from specific 
pizza types 


pizza = createPizza ( pizzaType ); 


pizza. bake ( ) ; 
pizza.cut(); 
pizza.box(); 

return pizza; 


} 


// defer to subclass to instantiate 
// Pizza of the appropriate type 
public abstract Pizza createPizza( 
String pizzaType ); 


factory 

method 


PizzaStore 


+orderPizza( String ) 
+createPizza( String ): Pizza 


NewYorkStylePizzaStore 


ChicagoStylePizzaStore 





+createPizza( String ): Pizza 


+createPizza( String ): Pizza 


) 
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Factory Method Approach 

public class NewYorkStylePizzaStore 
extends PizzaStore { 

public Pizza createPizza( String pizzaType ) { 

if (pizzaType.equals( "pepperoni" ) { 

Pizza pizza = 

new NewYorkStylePepperoniPizza(); 

} else if (pizzaType.equals ( "veggie" ) { 

Pizza pizza = 

new NewYorkStyleVeggiePizza (); 

} 

return pizza; 

} 

} 


Factory Method Pattern 

Design intent: 

"define an interface for creating an object, but lets 
subclasses decide which actual class to instantiate" 


abstract Product factoryMethod ( String type ); 


decouple client code in the superclass from the object 
creation code in the subclass 
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Factory Method Structure 



Exercise 


Problem: 

designing a framework 

• Application and Document superclasses 
an actual application would subclass these 

• add MyApplication and MyDocument subclasses 

• but do not change the code of the superclasses 


write a general NewDocument method in Application that 
ultimately instantiates a MyDocument 


70 


71 

















Example Structure 


Product 


Creator 



factory method 


also known as Virtual Constructor 
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